package com.sky.service;

import com.sky.dto.*;
import com.sky.result.PageResult;
import com.sky.vo.OrderPaymentVO;
import com.sky.vo.OrderStatisticsVO;
import com.sky.vo.OrderSubmitVO;
import com.sky.vo.OrderVO;

/**
 * @author zzw
 * @date 2025/5/16
 * @description 订单服务接口
 */
public interface OrderService {
    /**
     * 根据id查询订单
     *
     * @param id 订单id
     * @return 订单详情信息
     */
    OrderVO getById(Long id);

    /**
     * 订单分页查询
     *
     * @param ordersPageQueryDTO 订单查询条件封装对象
     * @return 订单分页结果
     */
    PageResult<OrderVO> page(OrdersPageQueryDTO ordersPageQueryDTO);

    /**
     * 取消订单
     *
     * @param ordersCancelDTO 订单取消数据封装对象
     */
    void cancel(OrdersCancelDTO ordersCancelDTO);

    /**
     * 统计各个状态的订单数量
     *
     * @return 订单统计信息
     */
    OrderStatisticsVO getOrderStatistics();

    /**
     * 订单确认
     *
     * @param id 订单id
     */
    void complete(Long id);

    /**
     * 订单拒绝
     *
     * @param rejectionDTO 订单拒绝数据封装对象
     */
    void reject(OrdersRejectionDTO rejectionDTO);

    /**
     * 订单确认
     *
     * @param confirmDTO 订单确认数据封装对象
     */
    void confirm(OrdersConfirmDTO confirmDTO);

    /**
     * 订单派送
     *
     * @param id 订单id
     */
    void delivery(Long id);

    /**
     * 订单提交
     *
     * @param ordersSubmitDTO 订单提交数据封装对象
     * @return 订单提交结果
     */
    OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO);

    /**
     * 订单支付
     *
     * @param ordersPaymentDTO 订单支付数据
     * @return 订单支付结果
     */
    OrderPaymentVO payment(OrdersPaymentDTO ordersPaymentDTO) throws Exception;

    /**
     * 支付成功，修改订单状态
     *
     * @param outTradeNo 微信支付返回的订单号
     */
    void paySuccess(String outTradeNo);

    /**
     * 用户催单
     *
     * @param id 订单id
     */
    void reminder(Long id);

    /**
     * 用户端订单分页查询
     *
     * @param page     当前页码
     * @param pageSize 每页记录数
     * @param status   订单状态
     * @return 订单分页结果
     */
    PageResult<OrderVO> pageQuery4User(int page, int pageSize, Integer status);

    /**
     * 查询订单详情
     *
     * @param id 订单id
     * @return 订单详情
     */
    OrderVO details(Long id);

    /**
     * 用户取消订单
     *
     * @param id 订单id
     */
    void userCancelById(Long id) throws Exception;

    /**
     * 再来一单
     *
     * @param id 订单id
     */
    void repetition(Long id);
}
